home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / czc030.zip / CZ_CHECK.DOC next >
Text File  |  1990-12-01  |  5KB  |  158 lines
  1.                               ┌──────────┐
  2.                               │ CZ_CHECK │
  3.                               └──────────┘
  4.  
  5. Rev 0.3 1st Dec 1990
  6. --------------------
  7.  
  8. Rev 0.2 was double-spacing the text of any .MES file that it fixed.
  9. This revision corrects that, and also another problem which could cause an
  10. 'unable to malloc' error when processing multiple message bases.
  11.  
  12.  
  13. Rev 0.2 29th Nov 1990
  14. ---------------------
  15.  
  16. Revised so it can FIX as well as find ...
  17.  
  18. Instead of the optional command, use the keyword FIX on the command line,
  19. eg
  20.  
  21.         cz_check 5 @c:\gt\gtmdir.bbs fix
  22.  
  23. which will find and fix all .MES files containing ^Z in the message
  24. bases listed in the specified gtmdir.bbs filw.
  25.  
  26. - - -
  27.  
  28. CZ_CHECK is a program for GT16 beta testers - it checks message bases to
  29. see if any recently-updated .MES files contain ^Z characters.
  30.  
  31. These can cause problems with some companion programs, which are likely to
  32. be fixed in the near future, but this will help you keep the message base
  33. clean until that happens.
  34.  
  35. You can either :
  36.  
  37. a)      just display the .MES file name,
  38.  
  39. b)      execute your editor with the offending file, or
  40.  
  41. c)      strip out the ^Z characters.
  42.  
  43.  
  44. ┌─────────────┐
  45. │ The Command │
  46. └─────────────┘
  47.  
  48.  
  49. For a single message base :
  50.  
  51.                  ┌──────────────────────── age limit, in days
  52.                  │       ┌──────────────── the message base directory
  53.                  │       │      ┌───────── (optional) command to execute
  54.                  ┴ ──────┴───── ┴               if ^Z found
  55.         cz_check 5 d:\msgs\ansi q
  56.  
  57. For multiple message bases :
  58.  
  59.                  ┌───────────────────────────── age limit, in days
  60.                  │       ┌───────────────────── a gtmdir file
  61.                  │       │           ┌───────── (optional) command to execute
  62.                  ┴ ──────┴────────── ┴───            if ^Z found
  63.         cz_check 5 @c:\gt\gtmdir.bbs edit
  64.  
  65. To FIX a message base, use the word FIX in place of the command, eg
  66.  
  67.         cz_check 5 @c:\gt\gtmdir.bbs fix
  68.  
  69.  
  70. ┌───────────┐
  71. │ Age Limit │
  72. └───────────┘
  73.  
  74. The age limit restricts checking to .MES files that have been created
  75. or updated withing the specified number of days.  This should catch
  76. all new messages *and* any edited messages.
  77.  
  78. First time, run with a large number, eg 90 days.  This should find any
  79. problems, however old they may be.
  80.  
  81. Subsequently, you can save time by specifying a short period, eg 3 days.
  82. If you're running it every day that will save some time.
  83.  
  84. Nominally, 0 means "any time today", 1 means "since yesterday morning",
  85. etc.  But please allow for the possibility that timezones may interfere
  86. with things.  If in doubt, add a day or two.
  87.  
  88. Important:      If you find anything that manages to update a .MES file
  89.                 (apart from direct access by a disc maintenance program)
  90.                 *without* changing its time and date, please let me know -
  91.                 that would really screw things up in a shared environment !
  92.  
  93.  
  94. ┌───────────────────┐
  95. │ Message Base Spec │
  96. └───────────────────┘
  97.  
  98. As the examples show, this can either be
  99.  
  100. a)      the name of a single message base directory, or
  101.  
  102. b)      an @ followed by the full path to a gtmdir.bbs file, in which case
  103.         all message bases listed in that gtmdir.bbs file will be checked
  104.         sequentially.
  105.  
  106.  
  107. ┌──────────────────┐
  108. │ Optional Command │
  109. └──────────────────┘
  110.  
  111. The command, if used, would normally be the name of a convenient editor,
  112. which would be executed along with the name of the offending .MES file, so
  113. that you can correct the error.
  114.  
  115. If the optional command is not specified, errors will simply be displayed.
  116. You may find it convenient to run with CONCOPY to save the output, or
  117. just redirect to a file by
  118.  
  119.         cz_check params....   > cz.out
  120.  
  121. If you want to FIX any errors, put FIX in place of the command name.
  122.  
  123.  
  124. ┌─────────────────┐
  125. │ Using an Editor │
  126. └─────────────────┘
  127.  
  128. If you are using an editor to fix the files, you'd better check that it
  129. doesn't discard information after a ^Z. Some of the problem files contain
  130. the ^Z in the middle of the file rather than at the end.
  131.  
  132. Also, check it isn't configured to *add* ^Z to files it saves.  Not much
  133. point in editing them out if the editor's going to put one back!
  134.  
  135. In Qedit, you can search for a ^Z within the body of a file, using CTRL-P
  136. CTRL-Z (which displays as a right arrow) in the search field.
  137.  
  138. Note also that Qedit will not *show* you a ^Z at the end of the file.  If
  139. you can't find a ^Z in the body of the file, force a resave with ESC-F-S
  140. which should save the file without the ^Z.  (To prove it, run cz_check
  141. again).
  142.  
  143.  
  144. ┌──────────────┐
  145. │ About FIXing │
  146. └──────────────┘
  147.  
  148. In most cases, the automatic fix will be all that is needed.
  149.  
  150. The assumption is that the ^Z characters should NOT have been in
  151. the file, but all else is in proper order.  The file is simply rewritten,
  152. omitting any ^Z characters that are found.
  153.  
  154.  
  155. Harry Green 050/003
  156. 29th November 1990.
  157.  
  158.